home *** CD-ROM | disk | FTP | other *** search
/ Turnbull China Bikeride / Turnbull China Bikeride - Disc 2.iso / BARNET / FREENET / BRODIE / FILEX_0 / !Filex / !Help next >
Text File  |  1995-05-09  |  3KB  |  77 lines
  1.  
  2.  
  3.                                 Filelist & Filex
  4.                                 ================
  5.  
  6.                            Written By: Stewart Brodie
  7.                            ==========================
  8.  
  9.                              Sunday, 26th July 1992
  10.                Modified Tuesday, 9th May 1995
  11.  
  12.                                       --
  13.  
  14.  
  15.         A library for C programs which require windows containing
  16.         icons and text for resources, simlilar to the way that the
  17.         Filer presents files.
  18.  
  19.  
  20. Legal Status and Conditions
  21. ===========================
  22.  
  23.     Basically: it is FreeWare; source supplied; author retains
  24.     copyright; author wants credit when library used in another
  25.     application.
  26.  
  27.         No liability is accepted for any loss or damage caused, or
  28.         allegedly caused, by the filelist library code, or by any
  29.         program which uses it.
  30.  
  31.     This code is copyright © Stewart Brodie, July 1992, May 1995.
  32.  
  33.  
  34. Introduction
  35. ============
  36.  
  37.         The Filelist library is a collection of C routines which provides
  38. facilities to display icons representing files or resources as required, in
  39. a similar fashion to that used by the standard Filer.  Indeed, one of the
  40. best uses for the library would be as a Filer for filing systems whose
  41. attributes make it unsuitable for interfacing with the standard Filer.
  42.  
  43.         The flexible interface allows much personal tailoring, with some
  44. default routines provided which can be overridden if required.  The example
  45. program provided (!Filex) uses the library to present a mini-Filer, which
  46. demonstrates some of the capabilities of the Filelist library.
  47.  
  48. Distribution
  49. ============
  50.  
  51.         The distribution contains a directory called !Filex.  This is the
  52. example program.  Within this directory, there are subdirectories c,h,l,o
  53. and s.  You will find the header file in h.filelist and the object code in
  54. o.filelist.  The example program is called c.filex.  The normal !Run,
  55. !Sprites, Sprites and Templates files are present, in addition to !Help
  56. (this file).  Furthermore, a makefile is present.  You should therefore be
  57. able to change directory to !Filex, and execute a `make' program eg. amu to
  58. build the program.  !RunImage is supplied.  To use the supplied makefile,
  59. you will need `cc', `squeeze' and `link' in the library directory (all
  60. supplied with C release 3 or later) and $.clib.o.risc_oslib for the Wimp
  61. libraries.
  62.  
  63. Usage
  64. =====
  65.  
  66.         Details of the routines provided are in h.filelist (the header
  67.     file). To use the routines, include the RISC OS lib wimp headers,
  68.     and then filelist.h in your program. Including the file h.wimpincls
  69.     will include everything necessary to use the risc_oslib. 
  70.  
  71.  
  72. E-Mail
  73. ======
  74.  
  75.         If you want to mail me about this program, then email to:
  76.     S.N.Brodie@ecs.soton.ac.uk
  77.